home *** CD-ROM | disk | FTP | other *** search
/ Top 101 Multimedia Shareware '93 / Top 101 Multimedia Shareware 1993.iso / flags / flags.doc next >
Text File  |  1989-05-13  |  18KB  |  381 lines
  1.                               FLAGS of the WORLD
  2.                                 version 6.04
  3.  
  4.                              Herbert F. Van Brink
  5.                              213-486-2865   days (8:00-4:00 Pacific)
  6.                                             There is an answering machine
  7.                                             at all other times.
  8.  
  9. Copyright Notice:  This program has been placed in the public domain.  No fees
  10. shall be charged for its distribution beyond minimal handling charges.  It is
  11. unlawful to distribute modified versions of this program, to "disassemble" it,
  12. or to reverse engineer it without the express written permission of the author.
  13.  
  14. The program may be incorporated into and made part of a larger system,
  15. providing that the above constraints are adhered to.
  16.  
  17.   PREREQUISITES:
  18.  
  19.        330K of AVAILABLE memory.  The program will run with as little
  20.        as 315K, but the listing functions available through F7 may not
  21.        work properly.
  22.  
  23.        Color Graphics Adaptor & Display or 128/256K Enhanced Graphics Adaptor
  24.        or equivalent.  Some flags will be shown only with EGA.
  25.        Has not been tested with 64K EGA cards, Hercules, etc.
  26.  
  27.        Certain adaptors have peculiarities:
  28.            QUADram and VEGA EGA cards, if used with a CGA monitor or an EGA
  29.            monitor but the switches are set to CGA initial mode, must have
  30.            CGA emulation enabled  (QEGA CGA:on  or   VEGA CGA:on).  Other cards
  31.            may be similar.
  32.  
  33.            Paradise AutoSwitch cards are supposed automatically to enable CGA
  34.            emulation.
  35.  
  36.            If you get magenta instead of a pure red, you don't have
  37.            complete CGA emulation in effect.
  38.  
  39.   PROGRAM DESCRIPTION:
  40.  
  41.        Over 275 different national, state, and organization flags, in FULL
  42.        COLOR, are included in this educational program.  The 275 flags appear
  43.        on 199 screens; Multiple flags are shown for various nations'
  44.        state flags, U.S. historical flags, and some groups of federated
  45.        countries.  Over fifty national anthems are included and can be heard
  46.        as either the opening theme or completely by selecting with the F5 key.
  47.  
  48.        There are three different modes of operation; each may be selected at any time via the
  49.        function keys:
  50.  
  51.                 (1) Automatic (Flags are shown in alphabetical order with no
  52.                                intervention required)
  53.  
  54.                 (2) Flags by request  (Select highlighted country
  55.                                        or press F4 and enter name)
  56.  
  57.                 (3) Random Quiz       Name not shown until requested
  58.  
  59.        AUTOMATIC:
  60.  
  61.         All of the flags are displayed, from the current position, in
  62.         alphabetical order.   Pressing any key will terminate the automatic
  63.         operation and provide further options.  (Initiated by the F3 key)
  64.  
  65.        BY REQUEST:
  66.  
  67.         The user is asked to select, by name or by selecting the name on the
  68.         screen, the next flag to be displayed.  Each flag remains on the screen
  69.         until another is requested.  Some alternate spellings and country names
  70.         in their own language are acceptable.     (F4 initiates typing in a
  71.         name;  F1 presents a list that can be pointed to with the arrow keys)
  72.  
  73.        RANDOM QUIZ:
  74.  
  75.         The program randomly selects a flag to be displayed, and asks for its
  76.         identification.    (F2 initiates; F2 must be pressed each time)
  77.  
  78.     USE:    Most current key options are always displayed.
  79.             (F8 "Stop the Music" and F9 "Boss Key" are not)
  80.  
  81.         After a selection is made from the listing screen, no options are
  82.         displayed initially; any key will display them.  Function keys will
  83.         perform their function when appropriate. [Note to users of earlier
  84.         versions:  The annoying "double key stroke" has been eliminated.]
  85.  
  86.         A + or - at any time will display the next (+) or previous (-) flag.
  87.  
  88.         FUNCTION KEY OPTIONS:
  89.  
  90.               F1:  Show the complete list of flags
  91.                      The home, end, and arrow keys move the cursor
  92.                      The PgUp and PgDn keys move to other pages
  93.                      The Enter Key selects the highlighted flag
  94.  
  95.               F1:  Display a Help Screen
  96.                      When the complete listing is on the screen, pressing F1
  97.                      will present a very shortened version of this document.
  98.  
  99.               F2:  A randomly selected flag is shown, the viewer is
  100.                      asked to identify the flag, and then the correct
  101.                      identification is shown, along with these options.
  102.  
  103.               F3:  Initiates an automatic mode in which each flag is
  104.                      shown on the screen for five seconds.  Pressing the
  105.                      "+" key will advance to the next flag immediately,
  106.                      while pressing the "-" key will back up to the previous
  107.                      flag.   The letter "H" will keep the flag on the screen
  108.                      for an additional five seconds.  (The length of time may
  109.                      be altered with the F6 key.)
  110.  
  111.                      Pressing any other key will terminate the Automatic
  112.                      mode and show these options.
  113.  
  114.               F4:  Allows the name of a country to be entered.  If the
  115.                      program recognizes the name as entered, that flag
  116.                      is shown.   Some names in the language of the country
  117.                      and alternate spellings are accepted.  Incorrect spellings
  118.                      are not accepted.
  119.  
  120.               F5:  Music selector:  Cycles through three different settings.
  121.                          Off:    No music
  122.                          Short:  Introduction or Principal Theme
  123.                          Long:   Complete National Anthems
  124.                                  When in the "Long" mode, some of the anthems
  125.                                  will play for over two minutes.  Pressing F8
  126.                                  will stop the music within the next 32 notes.
  127.  
  128.               F6:  Selects the length of time (in seconds) that a flag
  129.                      remains on the screen when in automatic mode or after
  130.                      being selected from the list.
  131.                      (minimum is one second, maximum is 99 seconds)
  132.  
  133.               F7:  Special Functions
  134.                      A menu of special functions is presented:
  135.  
  136.                    Color Test
  137.                      One (CGA) or Nine (EGA) screens are presented which
  138.                      show all of the colors which it is possible to
  139.                      display.  The descriptions of the colors should be
  140.                      reasonable enough to indicate whether the adaptor/
  141.                      display has any major malfunction.
  142.  
  143.                    Print Flag List
  144.                      Prints the list of flags to the printer assigned to PRN
  145.  
  146.                    National Anthems list
  147.                      Displays a list of the national anthems included.
  148.                      REQUIRES THAT AN UNMODIFIED COPY OF FLANTHEM.DOC
  149.                      be in the current directory.
  150.  
  151.               F8:  Stops the music within the next thirty-two notes.
  152.                    (This does not appear on the function key menu.)
  153.  
  154.               F9:  [Not Shown on Menus] A "Boss Key" that displays a
  155.                      typical spreadsheet screen (with accurate time
  156.                      and date!).  Any key returns to the flags program.
  157.  
  158.               F10: Exits the program
  159.  
  160.  
  161.   FLAG NOTES:
  162.  
  163.         Except where noted, the flags are believed to be current as of the
  164.         issue date of this program.  The designs are taken from a variety of
  165.         sources, principally:
  166.            the United Nations
  167.            the World Almanac
  168.            Works of Dr. Whitney Smith
  169.                 (Executive Director of the Flag Research Center in
  170.                 Winchester, Massachusetts)
  171.            The Orbis Flag Encyclopedia, William Crampton, ed.
  172.            World of Flags; poster by Bartholomew & Sons., Ltd.
  173.            Flags of American History, D.D.Crouthers, Hamond, Inc.,pub.
  174.            Numerous Atlases
  175.  
  176.         The author is indebted to Dr. Steven Carol of the International
  177.         Relations Center in Holbrook, New York, who has provided vexillogical
  178.         assistance, many of the current national anthems, and numerous
  179.         suggestions.
  180.  
  181.         Many of the national anthems have been transcribed from "National
  182.         Anthems of the World", M. Shaw and H. Coleman, ed.  This 1960
  183.         compendium was published by Blandford Press of London.  Even the United
  184.         Nations and the Olympic Organizing committees have problems keeping up
  185.         to date with these.
  186.  
  187.         Where nations have different flags (for example, flags used for
  188.         government offices and for civil uses), this program includes the
  189.         simpler one (usually the civil flag).  Thus, the flags of Ecuador,
  190.         Haiti, and others are the versions without a coat of arms.  Flags
  191.         have not been omitted because of any biases on the part of the
  192.         author;  Mexico, Portugal, Romania, The United Nations, and many other
  193.         missing flags require more drawing effort than the author is willing to
  194.         undertake.  Similarly, Malta and a few others are missing significant
  195.         portions of their emblazonments (E.g., Malta is missing the detail of
  196.         the cross, South Korea is missing its black rectangles, The Vatican
  197.         omits the keys, and Bhutan's dragon is in hibernation).  These
  198.         omissions are noted when the flag is displayed.
  199.  
  200.         Particular colors and shades must, of course, be approximated both
  201.         under CGA and EGA.  Further, the tuning of the monitor has much more
  202.         of an effect than any color choice.  Similarly, flag proportions,
  203.         which vary from 1:1 to 1:2 (most often 3:5, 2:3, and 1:2) are not
  204.         accurately portrayed in this program.  The file FLAGSIZE.DOC
  205.         describes the proper proportions for most of the flags.
  206.  
  207.  
  208.       LIMITATIONS       Designed for CGA and EGA
  209.       AND
  210.       TECHNICAL
  211.       NOTES
  212.  
  213.        The large number of graphics displayed by this program are the
  214.        result of their being created each time they are shown, rather
  215.        than being saved in their entirety, as is done in many other
  216.        graphic programs.  Another result is, unfortunately, a much
  217.        slower execution time.  Some of the more complex flags (the
  218.        current Lesotho flag, for example), are even slow on 286 and
  219.        386-based computers.  An EGA with an 8088-based system and no
  220.        math co-processor is likely to have intolerable performance,
  221.        particularly when displaying some of the multi-flag screens or flags
  222.        with many stars, each of which has a different orientation.
  223.        (Cook Islands is probably the slowest flag with its many stars,
  224.        each of which must be drawn separately).
  225.  
  226.        If it is desired that any of the EGA flag images be captured for
  227.        other uses, the capture program must be able to handle the
  228.        640x400 16-color ega mode.  Very few of the currently available
  229.        capture utilities have this facility.  Word Perfect's GRABBER
  230.        is one that does.  It does not capture the current palette, however.
  231.  
  232.        CGA Limitations:
  233.        Because of the limitations of IBM's color graphics mode, providing
  234.        only two color palettes of three colors (plus background) each,
  235.        there are many flags which the IBM PC is incapable of portraying
  236.  
  237.        A very few flags (particularly India and South Africa) are not shown
  238.        in their proper colors when the program is run with a CGA.
  239.        Others cannot be shown in CGA because of the limited color
  240.        combinations available, and are displayed only if an EGA or VGA
  241.        is in use.  Approximately one third of the flags cannot be shown
  242.        unless EGA is available.
  243.  
  244.        Some of the color combinations used here, especially RED, WHITE, and
  245.        BLUE, may not be accurately presentable on IBM-compatibles (or with non-
  246.        IBM CGA cards or emulators), since this particular palette combination
  247.        is created by invoking an un-documented peculiarity of the IBM PC.  It
  248.        was tested successfully on some early PC clones.  (Interestingly, later
  249.        versions of IBM BASIC, when running with EGA but in SCREEN 1 (CGA) mode,
  250.        does not support this directly, either.)   Technical note: It is invoked
  251.        by SCREEN 1,1  or by using OUT 984,14
  252.  
  253.        I have been informed that an earlier version (with no EGA support)
  254.        worked satisfactorily on the PCjr except for some color variations.
  255.  
  256.        There are some off-brand  ega boards in the field that do not support
  257.        all of the standard IBM EGA Screen modes.  (This can also be caused by
  258.        improper switch settings on an EGA or VGA adaptor.) This program was not
  259.        designed to work with incompatible hardware.  Version 5.0 was modified
  260.        to use SCREEN 7 (320x200, 16 color) if SCREEN 9 (650x350,16 colors out
  261.        of 64) cannot be used.
  262.  
  263.        Many EGA cards are prone to not displaying the deepest available
  264.        red color (used in the flags of Qatar and two of the Ecuadorian states).
  265.        This is often the result of the board being improperly seated in its
  266.        slot or the wrong initial setting of the toggle switch. Use the color
  267.        test available via the F7 key to verify your system.
  268.  
  269.        The current version of the program was compiled under QuickBasic 4.5.
  270.        Earlier versions were compiled under the IBM Basic Compiler 1.0 and
  271.        prior releases of QuickBasic.
  272.  
  273.    PROGRAM HISTORY:
  274.  
  275.      This release (6.04) is expected to be the last available version.  No
  276.      further additions or enhancements are planned.
  277.  
  278.      Version Numbering:  Whole number changes reflect major functional
  279.      enhancements.  First decimal changes are substantial content improvements;
  280.      changes in the second decimal position are lesser modifications (add a few
  281.      flags, correction of minor errors --spelling, internal documentation, a
  282.      color or two, etc.).  The versions marked with an asterisk (*) have not
  283.      been publicly released (they were sent to individual requestors who may
  284.      have released them to bulletin boards).
  285.  
  286.          Version 6.04
  287.  
  288.            Adds F8 key to stop the music
  289.            Eliminates extra keystrokes (any recognized key will perform
  290.               its function; others still display options)
  291.            Adds over 40 additional national anthems.
  292.            Adds long and short versions of anthems.
  293.            Adds the ability to print a list of the flags. (via F7)
  294.            Adds a listing of available national Anthems (via F7)
  295.            Adds a U.S. State Flags section.
  296.            Adds a U.S. Historical Flags section.
  297.            Some additional flags (PLO, Curacao, Manchukuo, Buddhism)
  298.            Is created under MicroSoft QuickBasic 4.5
  299.  
  300.          Version 5.11*
  301.            Corrects numerous small errors in the program and in the flags.
  302.            Adds over 75 new flags, including local flags of Ecuador and Brazil,
  303.              the component states of Malaysia, and the members of the United
  304.              Arab Emirates.
  305.            Adds Color Test (F7), Boss Key (F9)
  306.            Adds Second comment line
  307.            Adds Bhutan, Congo Dem Rep, Burma (no rice stalk), Brunei
  308.                 Estonia, Latvia, Lithuania, Cook Isl., Biafra, Marianas,
  309.                 Vatican city (no key), Turkish Cyprus, Niue, Sahara, Zimbabwe
  310.                 Vanuatu, Kenya, Angola, many others.
  311.            Corrects Thailand, Lebanon stripes, Chile error, Senegal error
  312.            Corrects historical associations of the various Congos
  313.  
  314.          Version 5.03*
  315.            Added Dominica, Liechtenstein, El Salvador, Nicaragua, Costa Rica
  316.            Olympic Rings linked.
  317.  
  318.          Version 5.02*
  319.            Added Uruguay, Zambia bird, Zaire, Cyprus, Mongolia.
  320.  
  321.          Version 5.01*
  322.            Miscellaneous minor fixes; speed up for Singapore, high resolution
  323.            for Canada & Lebanon, better colors for Tuvalu and Curacao.
  324.  
  325.          Version 5.00
  326.            Added flags (Tuvalu, St. Vincent, others); Corrected minor errors;
  327.            Added support for ega adaptors that do not support full ega graphics
  328.            (see technical notes)
  329.          Version 4.3*
  330.            Adds Malaysia, adds the ability to select next (+) or previous (-)
  331.            flag from almost any point.  Compilation is now under QuickBasic 4.0
  332.  
  333.            Version 4.0 Changes
  334.            The program has been made less sensitive to upper and lower case
  335.            distinctions.
  336.  
  337.            The 43-line mode is used for listing the flags if an EGA is in use.
  338.            A few additional flags have been added (Tanzania, Olympics, others).
  339.            Timing control of the automatic mode has been added.
  340.  
  341.          VERSION 3.0
  342.  
  343.            This version includes "Flags by Request", automatic, and quiz
  344.            options.
  345.  
  346.  
  347.        ┌────────────────────────────────────────────────────────────┐
  348.        │                                                            │
  349.        │   LOOK FOR   "INTERNATIONAL SIGNAL FLAGS"                  │
  350.        │                SIGNALS.ARC                                 │
  351.        │          Available now on your favorite bulletin board.    │
  352.        │                                                            │
  353.        │           Displays the Int'l Nautical Flag Set and         │
  354.        │           lets you "type" messages using flags             │
  355.        │           instead of characters.                           │
  356.        │                                                            │
  357.        └────────────────────────────────────────────────────────────┘
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.